7.1.1 Crear orden de pago de billetera MINPAY

#Breve descripción: interfaz comercial de recarga de RMB del código de escaneo de billetera MINPAY. Los usuarios pueden completar la recarga de CNY en su cuenta de billetera escaneando el código QR.

• Método de solicitud: POST
• Interfaz de solicitud: https://gateway-domain/wallet-trade-merchant/v1/receive/internal/api/create
• Solicitar tipo de medio (formato de datos JSON) Tipo de contenido: aplicación/json

Parámetros de solicitud

Nombre del parámetro	Tipo	Obligatorio	Significado del parámetro	Descripción del parámetro
key	string	Sí	Clave de comerciante	apiKey
localOrderId	string	Sí	Número de pedido local de la plataforma comercial	La plataforma comercial genera un número de pedido único a nivel local
localUserId	string	No	ID de usuario local de la plataforma comercial	ID de usuario local de la plataforma comercial
amount	number	Sí	Monto del pago	Importe del pedido
notifyUrl	string	Sí	Dirección de devolución de llamada	Una vez realizado el pedido con éxito, la dirección del comerciante será notificada mediante una devolución de llamada API | (Para obtener detalles sobre la devolución de llamada, consulte el Documento 3)
successRedirectUrl	string	No	Dirección	Saltar automáticamente a la dirección después del éxito
currency	string	Sí	Moneda del pedido	Moneda del pedido (moneda admitida por la billetera)
expireSecond	Long	No	Marca de tiempo de vencimiento (segundos)
sign	string	Sí	Firma	Consulte Algoritmo de firma para obtener más detalles

Solicitar muestra json

{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "173322",
  "notifyUrl": "http://127.0.0.1:8080/merchant-demo/notify",
  "amount": 1,
  "currency": "USDT",
  "sign": "7f07092874886179997617567a98e20e"
}

Ejemplo de respuesta json

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
    "orderId": "273719658252609",
    "localUserId": null,
    "localOrderId": "173322",
    "orderType": "PAYMENT",
    "orderBizType": "PAYMENT_WALLET_SCAN",
    "paymentUrl": "https://walletapi.vapyapp.com/scan-pay/JJB7BvCtyxP3ieKk1pBpxnTposMtF4nvixsjdHCu7X8KEukfzB5h3bGa88Ke",
    "publicKey": "JJB7BvCtyxP3ieKk1pBpxnTposMtF4nvixsjdHCu7X8KEukfzB5h3bGa88Ke"
  }
}

La URL de pago devuelta muestra la página de pago, como se muestra a continuación:


Descripción del parámetro de datos de respuesta

Nombre del parámetro	Tipo	Significado del parámetro	Descripción del parámetro
orderId	string	ID de pedido
localUserId	string	Identificación del comerciante
localOrderId	string	Número de pedido local del comerciante
orderType	enum	Tipo de pedido	PAYMENT:支付订单 ｜ WITHDRA:提款订单
orderBizType	enum	Ordenar negocios	La descripción del tipo orderBizType es la siguiente
paymentUrl	string	Dirección	Dirección de pago
publicKey	string	Clave secreta	Clave de acceso público

descripción del tipo orderBizType:

1. PAYMENT_WALLET_SCAN Pago con código de escaneo de billetera MINPAY
2. PAYMENT_TRANSFER depósito directo de dirección vinculante de moneda digital
3. PAYMENT_ANY_DIGITAL_SCAN Escanee el código QR para pagar cualquier cantidad de moneda digital
4. FROMDRAW_WALLET retirar dinero a la billetera MINPAY
5. FROMDRAW_ANY_DIGITAL_WALLET Retirar moneda digital a cualquier billetera
6. PAYMENT_FIXED_DIGITAL_SCAN pago con código de escaneo de cantidad limitada en moneda digital
7. BATCH_PAY pago por lotes

La devolución de llamada devuelve datos json

De forma predeterminada, todos los parámetros de devolución de llamada participan en la verificación de firma. Para obtener detalles sobre los parámetros de devolución de llamada, consulte devolución de llamada ]

Datos de devolución de llamada

{
  "amount": 11,
  "bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
  "currency": "CNY",
  "key": "h3cS7dBltRU4W1wD",
  "localOrderId": "2820",
  "merchantActualAmount": 8.86,
  "merchantCurrency": "CNY",
  "merchantId": 303122065665,
  "merchantPaidAmount": 10.98,
  "merchantUserId": "97",
  "notifyTime": 1731572168370,
  "orderCreateTime": 1731572133082,
  "orderId": "273124814912907",
  "sign": "699806308a9e055114c378671b0d2a15",
  "status": "SUCCESS",
  "type": "PAYMENT",
  "userAmount": 1.55,
  "userCurrency": "USDT"
}

Cuando reciba la notificación de devolución de llamada, devuelva directamente la cadena éxito después de que se complete el procesamiento, lo que indica que el mensaje se recibió y procesó exitosamente. Después de que el sistema reciba la respuesta exitosa, ya no enviará la devolución de llamada repetidamente. Si no se recibe la respuesta esperada (no se devuelve el éxito o se devuelve una excepción), el sistema reenviará la notificación de devolución de llamada de acuerdo con el mecanismo de reintento escalonado, reintentando hasta 14 veces. Los intervalos de reintento actuales son: 15, 15, 30, 180, 600, 1200, 1800, 1800, 1800, 3600, 10800, 10800, 21600, 21600